home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / f90 / pxfgetarg.z / pxfgetarg
Encoding:
Text File  |  2002-10-03  |  2.8 KB  |  61 lines
  1. PXFGETARG(3F)                                         Last changed: 1-22-99
  2.  
  3.  
  4. NNAAMMEE
  5.      PPXXFFGGEETTAARRGG - Returns a command-line argument
  6.  
  7. SSYYNNOOPPSSIISS
  8.      CCHHAARRAACCTTEERR**_n _b_u_f
  9.      IINNTTEEGGEERR _m,, _i_l_e_n,, _i_e_r_r_o_r
  10.      CCAALLLL PPXXFFGGEETTAARRGG((_m,, _b_u_f,, _i_l_e_n,, _i_e_r_r_o_r))
  11.  
  12. IIMMPPLLEEMMEENNTTAATTIIOONN
  13.      UNICOS, UNICOS/mk, and IRIX systems
  14.  
  15. DDEESSCCRRIIPPTTIIOONN
  16.      On IRIX systems, this routine is in lliibbffoorrttrraann..ssoo which is linked by
  17.      default when compiling programs with the MIPSpro 7 Fortran 90 compiler
  18.      or when compiling programs with the --ccrraayylliibbss option to the MIPSpro
  19.      F77 compiler.
  20.  
  21.      The PPXXFFGGEETTAARRGG subroutine examines the command line used to invoke the
  22.      executing program and returns the _mth command-line argument in _b_u_f.
  23.  
  24.      When using the CF90 compiler or MIPSpro 7 Fortran 90 compiler on
  25.      UNICOS, UNICOS/mk, or IRIX systems, all arguments must be of default
  26.      kind unless documented otherwise.  On UNICOS and UNICOS/mk, default
  27.      kind is KKIINNDD==88 for integer, real, complex, and logical arguments; on
  28.      IRIX, the default kind is KKIINNDD==44.
  29.  
  30.      This routine has the following arguments:
  31.  
  32.      _m       An input integer variable or array element containing the
  33.              number of the command-line argument to return in _b_u_f.  If _m is
  34.              zero, the command name is returned in _b_u_f.
  35.  
  36.      _b_u_f     An output character variable or array element containing the
  37.              _mth command-line argument.
  38.  
  39.      _i_l_e_n    An output integer variable containing the significant length
  40.              in characters of the string stored in _b_u_f.  If the length of
  41.              the string is shorter than the length of _b_u_f, the shorter
  42.              length is returned.  If the string is longer, the longer
  43.              length of the string is returned.
  44.  
  45.      _i_e_r_r_o_r  An output integer variable containing 0 if a value is returned
  46.              in _b_u_f or containing the following:
  47.  
  48.              EEIINNVVAALL    If _m is out of range
  49.  
  50.              EETTRRUUNNCC    if the declared length of _b_u_f is insufficient to
  51.                        contain the string to be returned.  The value of the
  52.                        command-line argument is truncated to fit in _b_u_f,
  53.                        and _i_l_e_n is set to the full length of the original
  54.                        string.
  55.  
  56. SSEEEE AALLSSOO
  57.      IIPPXXFFAARRGGCC(3F)
  58.  
  59.      _A_p_p_l_i_c_a_t_i_o_n _P_r_o_g_r_a_m_m_e_r'_s _L_i_b_r_a_r_y _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l for the printed
  60.      version of this man page.
  61.